<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>exhaustive_match_mg [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_filters.html">过滤器</a> / <a href="toc_filters_match.html">Match</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">exhaustive_match_mg</span><span data-if="c" style="display:none;">exhaustive_match_mg</span><span data-if="cpp" style="display:none;">ExhaustiveMatchMg</span><span data-if="dotnet" style="display:none;">ExhaustiveMatchMg</span><span data-if="python" style="display:none;">exhaustive_match_mg</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">exhaustive_match_mg</span><span data-if="c" style="display:none;">exhaustive_match_mg</span><span data-if="cpp" style="display:none;">ExhaustiveMatchMg</span><span data-if="dotnet" style="display:none;">ExhaustiveMatchMg</span><span data-if="python" style="display:none;">exhaustive_match_mg</span></code> — Matching a template and an image in a resolution pyramid.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>exhaustive_match_mg</b>(<a href="#Image"><i>Image</i></a>, <a href="#ImageTemplate"><i>ImageTemplate</i></a> : <a href="#ImageMatch"><i>ImageMatch</i></a> : <a href="#Mode"><i>Mode</i></a>, <a href="#Level"><i>Level</i></a>, <a href="#Threshold"><i>Threshold</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>exhaustive_match_mg</b>(const Hobject <a href="#Image"><i>Image</i></a>, const Hobject <a href="#ImageTemplate"><i>ImageTemplate</i></a>, Hobject* <a href="#ImageMatch"><i>ImageMatch</i></a>, const char* <a href="#Mode"><i>Mode</i></a>, const Hlong <a href="#Level"><i>Level</i></a>, const Hlong <a href="#Threshold"><i>Threshold</i></a>)</code></p>
<p>
<code>Herror <b>T_exhaustive_match_mg</b>(const Hobject <a href="#Image"><i>Image</i></a>, const Hobject <a href="#ImageTemplate"><i>ImageTemplate</i></a>, Hobject* <a href="#ImageMatch"><i>ImageMatch</i></a>, const Htuple <a href="#Mode"><i>Mode</i></a>, const Htuple <a href="#Level"><i>Level</i></a>, const Htuple <a href="#Threshold"><i>Threshold</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ExhaustiveMatchMg</b>(const HObject&amp; <a href="#Image"><i>Image</i></a>, const HObject&amp; <a href="#ImageTemplate"><i>ImageTemplate</i></a>, HObject* <a href="#ImageMatch"><i>ImageMatch</i></a>, const HTuple&amp; <a href="#Mode"><i>Mode</i></a>, const HTuple&amp; <a href="#Level"><i>Level</i></a>, const HTuple&amp; <a href="#Threshold"><i>Threshold</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>ExhaustiveMatchMg</b>(const HImage&amp; <a href="#ImageTemplate"><i>ImageTemplate</i></a>, const HString&amp; <a href="#Mode"><i>Mode</i></a>, Hlong <a href="#Level"><i>Level</i></a>, Hlong <a href="#Threshold"><i>Threshold</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>ExhaustiveMatchMg</b>(const HImage&amp; <a href="#ImageTemplate"><i>ImageTemplate</i></a>, const char* <a href="#Mode"><i>Mode</i></a>, Hlong <a href="#Level"><i>Level</i></a>, Hlong <a href="#Threshold"><i>Threshold</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>ExhaustiveMatchMg</b>(const HImage&amp; <a href="#ImageTemplate"><i>ImageTemplate</i></a>, const wchar_t* <a href="#Mode"><i>Mode</i></a>, Hlong <a href="#Level"><i>Level</i></a>, Hlong <a href="#Threshold"><i>Threshold</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ExhaustiveMatchMg</b>(<a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, <a href="HObject.html">HObject</a> <a href="#ImageTemplate"><i>imageTemplate</i></a>, out <a href="HObject.html">HObject</a> <a href="#ImageMatch"><i>imageMatch</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Mode"><i>mode</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Level"><i>level</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Threshold"><i>threshold</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>.<b>ExhaustiveMatchMg</b>(<a href="HImage.html">HImage</a> <a href="#ImageTemplate"><i>imageTemplate</i></a>, string <a href="#Mode"><i>mode</i></a>, int <a href="#Level"><i>level</i></a>, int <a href="#Threshold"><i>threshold</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>exhaustive_match_mg</b>(<a href="#Image"><i>image</i></a>: HObject, <a href="#ImageTemplate"><i>image_template</i></a>: HObject, <a href="#Mode"><i>mode</i></a>: str, <a href="#Level"><i>level</i></a>: int, <a href="#Threshold"><i>threshold</i></a>: int) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">exhaustive_match_mg</span><span data-if="c" style="display:none">exhaustive_match_mg</span><span data-if="cpp" style="display:none">ExhaustiveMatchMg</span><span data-if="com" style="display:none">ExhaustiveMatchMg</span><span data-if="dotnet" style="display:none">ExhaustiveMatchMg</span><span data-if="python" style="display:none">exhaustive_match_mg</span></code> is an additional option for the
operator <a href="exhaustive_match.html"><code><span data-if="hdevelop" style="display:inline">exhaustive_match</span><span data-if="c" style="display:none">exhaustive_match</span><span data-if="cpp" style="display:none">ExhaustiveMatch</span><span data-if="com" style="display:none">ExhaustiveMatch</span><span data-if="dotnet" style="display:none">ExhaustiveMatch</span><span data-if="python" style="display:none">exhaustive_match</span></code></a> performing a matching of the image
<a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a> and the template <a href="#ImageTemplate"><i><code><span data-if="hdevelop" style="display:inline">ImageTemplate</span><span data-if="c" style="display:none">ImageTemplate</span><span data-if="cpp" style="display:none">ImageTemplate</span><span data-if="com" style="display:none">ImageTemplate</span><span data-if="dotnet" style="display:none">imageTemplate</span><span data-if="python" style="display:none">image_template</span></code></i></a>.
Hereby <a href="#ImageTemplate"><i><code><span data-if="hdevelop" style="display:inline">ImageTemplate</span><span data-if="c" style="display:none">ImageTemplate</span><span data-if="cpp" style="display:none">ImageTemplate</span><span data-if="com" style="display:none">ImageTemplate</span><span data-if="dotnet" style="display:none">imageTemplate</span><span data-if="python" style="display:none">image_template</span></code></i></a> will be moved over all points
of the region of <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a>, a matching criterion will be
calculated with regard to the parameter <a href="#Mode"><i><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></i></a>
and the result values will be stored in <a href="#ImageMatch"><i><code><span data-if="hdevelop" style="display:inline">ImageMatch</span><span data-if="c" style="display:none">ImageMatch</span><span data-if="cpp" style="display:none">ImageMatch</span><span data-if="com" style="display:none">ImageMatch</span><span data-if="dotnet" style="display:none">imageMatch</span><span data-if="python" style="display:none">image_match</span></code></i></a>.
</p>
<p>Of images having been filtered this way, normally only those areas
with good matching results are of interest. The size of the area to
be searched, i.e. the region of the input image <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a>,
determines decisively the runtime of the matching filter.
Therefore it is recommendable to use at first <code><span data-if="hdevelop" style="display:inline">exhaustive_match_mg</span><span data-if="c" style="display:none">exhaustive_match_mg</span><span data-if="cpp" style="display:none">ExhaustiveMatchMg</span><span data-if="com" style="display:none">ExhaustiveMatchMg</span><span data-if="dotnet" style="display:none">ExhaustiveMatchMg</span><span data-if="python" style="display:none">exhaustive_match_mg</span></code>
with reduced image resolution in order to determine a
“region of interest” in which good matching results can be expected;
then in this restricted area only the real matching (see also
<a href="exhaustive_match.html"><code><span data-if="hdevelop" style="display:inline">exhaustive_match</span><span data-if="c" style="display:none">exhaustive_match</span><span data-if="cpp" style="display:none">ExhaustiveMatch</span><span data-if="com" style="display:none">ExhaustiveMatch</span><span data-if="dotnet" style="display:none">ExhaustiveMatch</span><span data-if="python" style="display:none">exhaustive_match</span></code></a>) will be executed with normal resolution.
</p>
<p>Hereby the Gauss-pyramids of <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a> and <a href="#ImageTemplate"><i><code><span data-if="hdevelop" style="display:inline">ImageTemplate</span><span data-if="c" style="display:none">ImageTemplate</span><span data-if="cpp" style="display:none">ImageTemplate</span><span data-if="com" style="display:none">ImageTemplate</span><span data-if="dotnet" style="display:none">imageTemplate</span><span data-if="python" style="display:none">image_template</span></code></i></a>
will be composed (in particular the corresponding regions will be
transformed as well). Then on each level of the resolution pyramids -
starting with the startlevel <a href="#Level"><i><code><span data-if="hdevelop" style="display:inline">Level</span><span data-if="c" style="display:none">Level</span><span data-if="cpp" style="display:none">Level</span><span data-if="com" style="display:none">Level</span><span data-if="dotnet" style="display:none">level</span><span data-if="python" style="display:none">level</span></code></i></a> - the matching inside
the current “region of interest” will be executed. Whereby the
“region of interest” on the startlevel is equivalent to the
region of the input image <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a>.
After the filtering, a new “region of interest” is determined with
the help of a threshold operation and will be transformed on the
next resolution level:
</p>
<p><span class="pre">
    threshold(...:...:0,Threshold,...:),   if Mode = 'dfd'
    threshold(...:...:Threshold,255,...:), if Mode = 'norm_correlation'
</span>
</p>
<p>The final matching in the determined “region of interest” will then be
calculated with the highest resolution (<a href="#Level"><i><code><span data-if="hdevelop" style="display:inline">Level</span><span data-if="c" style="display:none">Level</span><span data-if="cpp" style="display:none">Level</span><span data-if="com" style="display:none">Level</span><span data-if="dotnet" style="display:none">level</span><span data-if="python" style="display:none">level</span></code></i></a> 0).
The output image <a href="#ImageMatch"><i><code><span data-if="hdevelop" style="display:inline">ImageMatch</span><span data-if="c" style="display:none">ImageMatch</span><span data-if="cpp" style="display:none">ImageMatch</span><span data-if="com" style="display:none">ImageMatch</span><span data-if="dotnet" style="display:none">imageMatch</span><span data-if="python" style="display:none">image_match</span></code></i></a> includes the corresponding
filter result and the final “region of interest”, which
is determined on the result image with the help of a threshold operation.
</p>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">exhaustive_match_mg</span><span data-if="c" style="display:none">exhaustive_match_mg</span><span data-if="cpp" style="display:none">ExhaustiveMatchMg</span><span data-if="com" style="display:none">ExhaustiveMatchMg</span><span data-if="dotnet" style="display:none">ExhaustiveMatchMg</span><span data-if="python" style="display:none">exhaustive_match_mg</span></code> therefore is not simply
a filter, but can also be considered as a member of the class of region
transformations.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>singlechannelimage(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte)</span>
</div>
<p class="pardesc">Input image.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageTemplate" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageTemplate</span><span data-if="c" style="display:none">ImageTemplate</span><span data-if="cpp" style="display:none">ImageTemplate</span><span data-if="com" style="display:none">ImageTemplate</span><span data-if="dotnet" style="display:none">imageTemplate</span><span data-if="python" style="display:none">image_template</span></code></b> (input_object)  </span><span>singlechannelimage <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte)</span>
</div>
<p class="pardesc">The domain of this image will be
matched with <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a>.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageMatch" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageMatch</span><span data-if="c" style="display:none">ImageMatch</span><span data-if="cpp" style="display:none">ImageMatch</span><span data-if="com" style="display:none">ImageMatch</span><span data-if="dotnet" style="display:none">imageMatch</span><span data-if="python" style="display:none">image_match</span></code></b> (output_object)  </span><span>image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (byte)</span>
</div>
<p class="pardesc">Result image and result region: values of the matching
criterion within the determined “region of interest”.</p>
<p class="pardesc"><span class="parcat">Number of elements:
      </span>ImageMatch == Image</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Mode" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Desired matching criterion.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'dfd'</span>
    <span data-if="c" style="display:none">"dfd"</span>
    <span data-if="cpp" style="display:none">"dfd"</span>
    <span data-if="com" style="display:none">"dfd"</span>
    <span data-if="dotnet" style="display:none">"dfd"</span>
    <span data-if="python" style="display:none">"dfd"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'dfd'</span><span data-if="c" style="display:none">"dfd"</span><span data-if="cpp" style="display:none">"dfd"</span><span data-if="com" style="display:none">"dfd"</span><span data-if="dotnet" style="display:none">"dfd"</span><span data-if="python" style="display:none">"dfd"</span>, <span data-if="hdevelop" style="display:inline">'norm_correlation'</span><span data-if="c" style="display:none">"norm_correlation"</span><span data-if="cpp" style="display:none">"norm_correlation"</span><span data-if="com" style="display:none">"norm_correlation"</span><span data-if="dotnet" style="display:none">"norm_correlation"</span><span data-if="python" style="display:none">"norm_correlation"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Level" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Level</span><span data-if="c" style="display:none">Level</span><span data-if="cpp" style="display:none">Level</span><span data-if="com" style="display:none">Level</span><span data-if="dotnet" style="display:none">level</span><span data-if="python" style="display:none">level</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Startlevel in the resolution pyramid (highest
resolution: Level 0).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 1, 2, 3, 4, 5, 6, 7, 8</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>Level &lt;= ld(width(Image)) &amp;&amp; Level &lt;= ld(height(Image)) &amp;&amp; Level &lt;= ld(width(ImageTemplate)) &amp;&amp; Level &lt;= ld(height(ImageTemplate))</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Threshold" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Threshold</span><span data-if="c" style="display:none">Threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">threshold</span><span data-if="python" style="display:none">threshold</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Threshold to determine the “region of interest”.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>30</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, 100, 105, 110, 115, 120, 125, 130, 135, 140, 145, 150, 155, 160, 165, 170, 175, 180, 185, 190, 195, 200, 205, 210, 215, 220, 225, 230, 235, 240, 245, 250</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Threshold</span>
    <span data-if="c" style="display:none">Threshold</span>
    <span data-if="cpp" style="display:none">Threshold</span>
    <span data-if="com" style="display:none">Threshold</span>
    <span data-if="dotnet" style="display:none">threshold</span>
    <span data-if="python" style="display:none">threshold</span>
    
          ≤
          255</code></p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>5</p>
</div>
<h2 id="sec_example_all">例程 (C)</h2>
<pre class="example">
read_image(&amp;Image,"monkey");
disp_image(Image,WindowHandle);
draw_rectangle2(WindowHandle,&amp;Row,&amp;Column,&amp;Phi,&amp;Length1,&amp;Length2);
gen_rectangle2(&amp;Rectangle,Row,Column,Phi,Length1,Length2);
reduce_domain(Image,Rectangle,&amp;Template);
exhaustive_match_mg(Image,Template,&amp;ImageMatch,'dfd'1,30);
invert_image(ImageMatch,&amp;ImageInvert);
local_max(ImageInvert,&amp;BestFit);
disp_region(BestFit,WindowHandle);
</pre>
<h2 id="sec_result">结果</h2>
<p>If the parameter values are correct, 该算子
<code><span data-if="hdevelop" style="display:inline">exhaustive_match_mg</span><span data-if="c" style="display:none">exhaustive_match_mg</span><span data-if="cpp" style="display:none">ExhaustiveMatchMg</span><span data-if="com" style="display:none">ExhaustiveMatchMg</span><span data-if="dotnet" style="display:none">ExhaustiveMatchMg</span><span data-if="python" style="display:none">exhaustive_match_mg</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .
If the input is empty (no input images are available) the behavior can
be set via <a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('no_object_result',&lt;Result&gt;)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>.
如有必要，将引发异常。</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="draw_region.html"><span data-if="hdevelop" style="display:inline">draw_region</span><span data-if="c" style="display:none">draw_region</span><span data-if="cpp" style="display:none">DrawRegion</span><span data-if="com" style="display:none">DrawRegion</span><span data-if="dotnet" style="display:none">DrawRegion</span><span data-if="python" style="display:none">draw_region</span></a></code>, 
<code><a href="draw_rectangle1.html"><span data-if="hdevelop" style="display:inline">draw_rectangle1</span><span data-if="c" style="display:none">draw_rectangle1</span><span data-if="cpp" style="display:none">DrawRectangle1</span><span data-if="com" style="display:none">DrawRectangle1</span><span data-if="dotnet" style="display:none">DrawRectangle1</span><span data-if="python" style="display:none">draw_rectangle1</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>, 
<code><a href="local_max.html"><span data-if="hdevelop" style="display:inline">local_max</span><span data-if="c" style="display:none">local_max</span><span data-if="cpp" style="display:none">LocalMax</span><span data-if="com" style="display:none">LocalMax</span><span data-if="dotnet" style="display:none">LocalMax</span><span data-if="python" style="display:none">local_max</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="exhaustive_match.html"><span data-if="hdevelop" style="display:inline">exhaustive_match</span><span data-if="c" style="display:none">exhaustive_match</span><span data-if="cpp" style="display:none">ExhaustiveMatch</span><span data-if="com" style="display:none">ExhaustiveMatch</span><span data-if="dotnet" style="display:none">ExhaustiveMatch</span><span data-if="python" style="display:none">exhaustive_match</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="gen_gauss_pyramid.html"><span data-if="hdevelop" style="display:inline">gen_gauss_pyramid</span><span data-if="c" style="display:none">gen_gauss_pyramid</span><span data-if="cpp" style="display:none">GenGaussPyramid</span><span data-if="com" style="display:none">GenGaussPyramid</span><span data-if="dotnet" style="display:none">GenGaussPyramid</span><span data-if="python" style="display:none">gen_gauss_pyramid</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
